awesome-qr
Advanced tools
An awesome but simple QR code generator written in JavaScript.
These QR codes were made with Awesome-qr.js 🤗
 |  |  |
Please use react-awesome-qr.
Type definitions are included in the npm package.
Please read ⚠️
Awesome-qr.js uses node-canvas as its drawing backend. You might need to take a look at its documentation to ensure that node-canvas works on your environment.
yarn add awesome-qr // using Yarn
npm install --save awesome-qr // using NPM
Awesome-qr.js prior to v2.0.0 does not work well in Node.js environment and Awesome-qr.js prior to v1.2.0 does not work in Node.js environment.
const { AwesomeQR } = require("awesome-qr");
const fs = require("fs");
// ...
const background = fs.readFileSync("background.png");
const buffer = await new AwesomeQR({
text: "AwesomeQR by Makito - Awesome, right now.",
size: 500,
backgroundImage: background,
}).draw();
fs.writeFileSync("qrcode.png", buffer);
<!-- import to the global scope -->
<script src="dist/awesome-qr.js"></script>
<!-- or use require.js -->
<script>
require(["dist/awesome-qr.js"], (AwesomeQR) => ...);
</script>
var background;
var reader = new FileReader();
reader.onload = function () {
background = this.result;
new AwesomeQR({
text: "AwesomeQR by Makito - Awesome, right now.",
size: 500,
backgroundImage: background,
}).draw().then((dataURL) => );
};
reader.readAsDataURL(file);
Options is an object that you can pass to the generator to customize your QR code.
Options {
text: string;
size?: number;
margin?: number;
typeNumber?: number;
correctLevel?: number;
dotScale?: number;
colorDark?: string;
colorLight?: string;
autoColor?: boolean;
backgroundImage?: string | Buffer;
backgroundDimming?: string;
gifBackground?: ArrayBuffer;
whiteMargin?: boolean;
logoImage?: string | Buffer;
logoScale?: number;
logoMargin?: number;
logoCornerRadius?: number;
};
string
Text to be encoded in the QR code.
number?, default: 400
Size of the QR code in pixel.
number?, default: 20
Size of margins around the QR code body in pixel.
number?, default: QRErrorCorrectLevel.M = 0
For more information, please refer to Error correction feature | QRcode.com | DENSO WAVE.
Error correction level of the QR code.
string?, CSS <color>, default: "#000000"
For more information about CSS <color>, please refer to <color> - CSS: Cascading Style Sheets | MDN
Color of the blocks on the QR code.
string?, CSS <color>, default: "#ffffff"
Color of the empty areas on the QR code.
boolean?, default: true
Automatically calculate the colorDark value from the QR code's background.
(string|Buffer)?, default: undefined
Background image to be used in the QR code.
Accepts a data: string in web browsers or a Buffer in Node.js.
string?, CSS <color>, default: "rgba(0, 0, 0, 0)"
Color of the dimming mask above the background image.
ArrayBuffer?, default: undefined
GIF background image to be used in the QR code.
boolean?, default: true
Use a white margin instead of a transparent one which reveals the background of the QR code on margins.
number?, default: 0.4
Ratio of the real size to the full size of the blocks.
This can be helpful when you want to make more parts of the background visible.
(string|Buffer)?, default: undefined
Logo image to be displayed at the center of the QR code.
Accepts a data: string in web browsers or a Buffer in Node.js.
When set to undefined or null, the logo is disabled.
number?, default: 0.2
Ratio of the logo size to the QR code size.
number?, default: 6
Size of margins around the logo image in pixels.
number?, default: 8
Corner radius of the logo image in pixels.
It is those generous sponsors who supports this project makes the Awesome-qr.js more awesome!
I'd like to express my sincere appreciation to all the generous sponsors.
Since sponsors' names will not show up here without their permissions, the list above only shows a part of all the sponsors. If you wish to have your name shown up here, please feel free to contact me.
Awesome-qr.js is inspired by EFQRCode by EyreFree.
EFQRCode is a tool to generate QRCode image or recognize QRCode from image, in Swift.
If your application is in need of generating pretty QR codes in Swift, take a look at EFQRCode. It should help.
Also, if you are developing Android apps, you can take a look at AwesomeQRCode, which is designed for Android projects.
Awesome-qr.js is licensed under Apache License 2.0 License.
Copyright (c) 2017-2020 Makito
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
jquery-qrcode
Copyright (c) 2011 Jerome Etienne, http://jetienne.com
Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:
The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
QRCode for JavaScript
Copyright (c) 2009 Kazuhiko Arase
URL: http://www.d-project.com/
Licensed under the MIT license:
http://www.opensource.org/licenses/mit-license.php
The word "QR Code" is registered trademark of
DENSO WAVE INCORPORATED
http://www.denso-wave.com/qrcode/faqpatent-e.html
FAQs
An awesome but simple QR code generator written in JavaScript.
The npm package awesome-qr receives a total of 1,199 weekly downloads. As such, awesome-qr popularity was classified as popular.
We found that awesome-qr demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
A Stanford study reveals 9.5% of engineers contribute almost nothing, costing tech $90B annually, with remote work fueling the rise of "ghost engineers."
Research
Security News
Socket’s threat research team has detected six malicious npm packages typosquatting popular libraries to insert SSH backdoors.
Security News
MITRE's 2024 CWE Top 25 highlights critical software vulnerabilities like XSS, SQL Injection, and CSRF, reflecting shifts due to a refined ranking methodology.